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-- 3D Groove Xtra --
-- MAIN FUNCTIONS --
* InitGroove string SerialNumber --launch Engine
* StepGroove -- Step into Engine Loop
* UpdateGroove -- Update rendeing window
* ExitGroove -- Shut down Engine (recommended before quitting application)
-- WORLD FUNCTIONS --
* LoadWorld string filename --Open GRV file and load default scene file-- RENDERING SETUP (called before InitGroove) --
* SetRenderMode int n --Set software/hardware rendering device : 0=Software: 'Double Buffer' (default), 1=Software: 'Single Buffer', 2=3Dfx Glide, 3=Direct3D
* RenderToScreen int ScreenWidth, int ScreenHeight --Attempts to set screen size to (ScreenWidth,ScreenHeight) and render to full screen
* RenderToWindow string WindowTitle,int x, int y, int Width, int Height --Creates and renders into new OS window 'WindowTitle' at window rect(x,y,x+Width,y+Height)
* RenderToStage --Draws into entire stage or browser window with offscreen clipping
* RenderToTexture int TextureID --Renders scene into 16-bit texture 'TextureID'
-- RENDERING PROPERTIES (can be dyanimcly set)--
* SetRenderWindow int x, int y, int xx, int yy --Set coordinates for rendering window (realtive to top-left of the current graphics contect (usually the screen))
* ClearRenderWindow --clear drawing window
* SetZbuffer int n --Z-buffer mode: on (1) or off (0)
* SetInterlace int n --Use interlacing when drawing to screen: on (1) or off (0)
* SetLineDouble int n --Use line doubling when drawing to screen: on (1) or off (0)
* SetAntiAlias int n --Turn Anti-Aliasing on (1) or off (0)
* SetMipMapping int n --Turn MipMapping on (1) or off (0) (should be called before loading textures or sprites)
* SetPerspective int n --Set camera focal perspective (default=60 degrees)
-- NAVIGATION COMMANDS --
* SetNavigation int mode --Set navigation mode: -1=none, 0=fly (default), 1=hover, 2=walk (no looking up) 
* SetAvatar int ObjectID --Selects avatar object for 3rd person navigation
* SetControl int device, int n --Set navigation control using mouse (0) or keyboard (1) to on/off 
-- ADD 3D OBJECTS --
* AddShape int index, int x, int y, int z -- Add Shape to World; returns shape's index number in world
* AddInstanceShape int index, int x, int y, int z -- Add Shape Reference to World; returns shape's index number in world
* AddSprite int index, int x, int y, int z -- Add Sprite to World; returns sprite's index number in world
* AddPrimitive int type, int size, int density, int TextureID, int x, int y, int z -- Add primitive object to World (type:1=sphere, 2=cylinder, 3=cube, 4=grid)
* AddLight int type, int x, int y, int z -- Add Light to World (type:0=directional, 1=positional); returns light's index number in world
-- LINKING AND HEIRARCHY FUNCTIONS --
* LinkObject int ChildObject, int ParentObject, int PositionLink, int PivotLink --Links two objects together based on Position ( if PositionLink=1) or orientation ( if PivotLink=1)
* UnlinkObject int ChildObject --detatches child object from parent object
* GetObjectParent int ObjectID --Returns parent object (if any) of object 'ObjectID'
* GetObjectChildren int ObjectID --Returns list of children objects (if any) of object 'ObjectID'
-- 3D GROOVE PROPERTY LIST FUNCTIONS --
* GetWorldInfo --Returns list of world properties
* GetCameraInfo --Returns list of camera properties
* GetObjectInfo int ObjectIndex --Returns list of object properties for object 'ObjectIndex'
* GetAssetInfo string AssetLib, int AssetIndex --Returns list of asset properties for asset 'AssetIndex' in asset library 'AssetLib' (e.g. 'shape', 'texture', etc.)
* SetWorldInfo list WorldData --Sets World properties to values in list 'WorldData'
* SetCameraInfo list CameraData --Sets Camera properties to values in list 'CameraData'
* SetObjectInfo int ObjectIndex, list ObjectData --Sets the properties of object 'ObjectIndex' to the values in list 'ObjectData'
* SetAssetInfo string AssetLib, int AssetIndex , list AssetData --Sets the properties of asset 'AssetIndex' of library 'AssetLib' to the values in list 'AssetData'
-- CAMERA FUNCTIONS --
* GetCamera --Get camera position and angle variables (sets globals: camerax,cameray,cameraz,viewx,viewy,viewz)
* RotateCamera int x, int y, int z --Set camera rotation
* MoveCamera int x, int y, int z --Set camera position to point (x,y,z)
* CameraLookAt int x, int y, int z --Point camera at position (x,y,z)
-- OBJECT FUNCTIONS --
* DeleteObject int n --removes object in index 'n' from world 
* GetObject int ObjectID --Get object in index 'n' position, angle and visibility variables  (sets globals: objx,objy,objz,objrx,objry,objrz,objvis)
  			  --Also sets globals (objvectorx,objvectory,objvectorz,objspinx,objspiny,objspinz,objspeed,objtype,objasset,objactive,objpath,objindex)
			  --and objradius, objpolys, objdots, objbfculling, objgroup)
* RotateObject int ObjectID, int x, int y, int z --Set object's orientation
* MoveObject int ObjectID, int x, int y, int z --Move object's position
* ScaleObject int ObjectID, int x, int y, int z --Scale object dimensions to x,y and z percent
* TiltObject int ObjectID, int x, int y, int z --Shift object's relative orientation relative by x, y and z degrees
* ShiftObject int ObjectID, int x, int y, int z --Shift object's position by x, y and z units
* SlideObject int ObjectID, int AngleH, int AngleV, int Distance --Slide object along slopes angleH and angleV by 'distance' units
* SpinObject int ObjectID, int x, int y, int z --Spin object continuously by x,y and z degrees
* OffsetObject int ObjectID, int x, int y, int z --Shift's an object's anchor point by x,y and z units
* CenterObject int ObjectID --Automaticaly centers an object's anchor point
* RestoreObject int ObjectID --Restores an object's properties to its asset's original values
* ReplaceObject int ObjectID, int AssetID --Replaces an object's shape data with that of a different asset
* SwapObject int ObjectID1, int ObjectID2 --Swaps an object's shape data with that of a different object
* ObjectLookAt int ObjectID, int x, int y, int z --Point object to position (x,y,z)
* SetObjectFocus int ObjectID, int TargetObjectID --Forces object 'ObjectID' to always point at object 'TargetObjectID' (TargetID: -1= no object, -2=last ObjectLookAt' target, -3=point object in current vector direction
-- OBJECT PROPERTIES --
* SetObjectAnchor int ObjectID, int x, int y, int z --Sets an object's anchor point relative to its center
* SetObjectVisible int ObjectID, int n --Set object visibility (1=visible 0=invisible)
* SetObjectBFCulling int ObjectID, int n --Set object back face culling (1=draw only the front face of the object's polygons; 0=draw both sides of the object's polygon)
* SetObjectSize int ObjectID, int width, int height, int depth --Resize object into bounding box with dimensions 'width', 'height' and 'depth'
* SetObjectDepth int ObjectID, int DepthValue --Forces an object's depth of field value to 'DepthValue', allowing objects to be artifially moved closer of further in the field of view (depth=-1 resets unlocks the forced depth of field value)
* SetObjectLock int ObjectID, int x, int y, int z --Constrains object's x, y and z position (if Lock=1), rotation (if Lock=2) or both (if Lock=3) along each axis
* SetObjectShape int ObjectID, int ShapeLibIndex --Set object geometry to model stored in 'ShapeLibIndex'
* SetObjectSprite int ObjectID, int spritenumber --Set object 'ObjectID' to sprite bitmap 'spritenumber' ID
* SetObjectTexture int ObjectID, int texture --Set object texture ID
* SetObjectMaterial int ObjectID, int material --Set object material ID
* SetObjectWireFrame int ObjectID, int n --Render object 'ObjectID' in wireframe if n=1
* SetObjectScreenLoc int ObjectID, int LocH, int LocV, int ScalePercent --Renders an object relative to the screen positions 'loch', 'locv' at scale 'ScalePercent', where (ScalePercent=100) renders the width of the screen
-- OBJECT MOTION AND PHYSICS PROPERTIES --
* SetObjectActive int ObjectID, int n --Set automatic object motion (vectors and spins) to on (1) or off (0)
* SetObjectCollision int ObjectID, int n --Set automatic object collision detecion to on (1) or off (0)
* SetObjectVector int ObjectID, float x, float y, float z --Set object vector motion values (x,y,z)
* SetObjectSpeed int ObjectID, float speed --Set object velocity to 'speed' (default=1.0) 
* SetObjectAcceleration int ObjectID, float speed, float vecx, float vecy, float vecz, float spinx, float spiny, float spinz  --Set object acceleration for velocuty (speed), vectors and spin (rotation(
* SetObjectRoll int ObjectID, int RollDegrees --Set object's automatic banking limit to 'RollDegrees' (will roll like a ball if 'RollDegrees'<0)
* SetObjectGravity int ObjectID, float grav --Set object's local gravity to value 'grav' (default=0.0) 
* SetObjectElasticity int ObjectID, float BounceValue --Set object's elasticity to 'BounceValue' (default=1.0) 
* SetObjectFriction int ObjectID, float friction --Set object's friction coefficient to 'friction' (default=0.0) 
* SetObjectPhysics int ObjectID, int PhysicsModel --Set object's physical behavior to type 'PhysicsModel' (default=0) 
-- OBJECT ANIMATION FUNCTIONS (Used with Multi-Frame Sprite and Shape Objects)--
* SetObjectAnimation int ObjectID, int PlaySpeed, int StartFrame, int EndFrame, int Loop --Set object's animation properties
* SetObjectFrame int ObjectID, int Frame --Set ObjectID's current frame index to value 'Frame' 
-- OBJECT PATH FUNCTIONS --
* SetObjectPath int ObjectID, int PathID --Moves Object along pre-recorded path 'PathID'
* SetObjectPathRelative int ObjectID, int Relative --Determines whether an object's path is relative (if 'Relative'=1) or absolute (if 'Relative'=0)
* SetObjectPathIndex int ObjectID, int Pathindex --Sets frame of object's current path to 'pathindex'
* SetObjectPathPlay  int ObjectID, int PlaySpeed, int Loop --Sets the playspeed (i.e. 'playspeed=2' fast forwards the animation at 200% normal speed) and looping of an object's path
* RecordObjectPath int ObjectID, string Filename, int keyframespace, int framecount --Records path of object 'ObjectID' to file 'filename' with number of frames 'framecount'
-- OBJECT FX COMMANDS --
* HighLightObject int ObjectID, int n --Highlight object with flashing effect when n=1, restore to normal when n=0
* ExplodeObject int ObjectID --Explode polygonal object
* SkewObject int ObjectID, int x, int y, int z --Skews an object by x, y and z percentage values
* TwistObject int ObjectID, int x, int y, int z --Twist's object's shape along each axis by x, y and z degrees
* BendObject int ObjectID, int x, int y, int z --Bend an object's shape along its anchorpoint by x, y and z degrees
* RippleObject int ObjectID, int x, int y, int z --Creates a ripple through object's mesh with frequencies (x,y and z) along each axis
* MeltObject int ObjectID, int percent --Melts an object's polygon mesh by percentage 'percent'
   -- GRAPHIC OVERLAY AND MASK FUNCTIONS -- 
* OverlayText string TextString, int X, int Y, int TextWidth, int TextHeight --overlay terminal text string over rendering screen at position (x,y) in a box with width 'TextWidth' and height 'TextHeigh'
-- STREAMING MOVIE COMMANDS --
* LoadMovieStream string filename, int preload --opens movie 'filename' for streaming, returns MovieID (if preload=1, then the whole movie is loaded into RAM)
* CloseMovieStream int MovieID --Closes Movie stream in index 'MovieID' and disposes of all memory related to the movie
* SetMovieStreamFrame int TextureID, int MovieID, int MovieFrame, int BlitMode --replaces texture in TextureID with frame 'MovieFrame' from movie 'movieID' (Blitmode 0: Solid, 1: Transparent, 2: Luminosity, 3: Chroma, 4: Darken, 5: Greenscreen, 6: Bluescreen
-- TEXTURE ANIMATION FUNCTIONS --
* SetTextureAlpha int TextureID, int AlphaMode, int AlphaBlend --Sets Alpha Blend FX mode for texture (blend sets global alpha opacity value for texture, between 0-255)
* SetTextureBilinear int TextureID, int BilinearFilterMode --Sets Bilinear Filtering mode (on/off) for texture 'TextureID'
* SwapObjectTexture int ObjectID, int TextureID1, int TextureID2 --Swaps TextureID1 with TextureID2 in Object 'ObjectID
* SwapWorldTexture int TextureID1, int TextureID2 --Swaps TextureID1 with TextureID2 throughout all objects in the 3D world
-- TEXTURE/MATERIAL MAPPING FUNCTIONS --
* ReplaceTexture int TextureID, string filename --Replaces texture 'TextureID' with bitmap file 'filename'
* ReplaceMaterial int MaterialID, int red, int green, int blue, int alpha, int emission, int  ambient, int diffuse, int specular, int shininess  --Sets material properties with color (red, green, blue, alpha) and light properties: emission, ambient, diffuse, specular,  shininess
* GetMaterialColor int MaterialID, int MatComponent --Returns RGB values of material 'MaterialID'  (MatComponent 1:emission, 2:ambient, 3:diffuse, 4:specular)
* SetMaterialColor int MaterialID, int MatComponent, int red, int green, int blue, int alpha --Set RGB and alpha values of material component (MatComponent 1:emission, 2:ambient, 3:diffuse, 4:specular)
* SetMaterialEnvMap int MaterialID, int EnvMapMode, int TexID --Attaches Environment Map Texture to material definition
* WrapTextureSpherical int ObjectID, int HorizontalTiles, int VerticalTiles, int OffsetX, int OffsetY --Wraps texture as sphere over shape object 'ObjectID'
* WrapTextureDirectional int ObjectID, int HorizontalTiles, int VerticalTiles, int OffsetX, int OffsetY --Wraps texture as directional plane over shape object 'ObjectID'
-- SHAPE UTILITIES --
* ReduceShapePolys int ShapeAssetID , int ThresholdAngle --Merges polygons with less then 'ThresholdAngle' degrees between them
* SetSmoothing int n --Turns smoothing on (n=1) or off (n=0) 
-- LIGHT FUNCTIONS --
* SetWorldLight int percent --sets ambient world light brightness as pecent of maximum (default=90%)
--  SetLight Values: (int LightIndex, int property, int a, int b, int c) 
--  Property 0=(general) a=brightness (0-100%) b=cutoffdistance (0=infinite) c=light on/off (1=on, 0=ff) --
--  Property 1=(ambient color); Property 2=(diffuse color); Property 3=(specular color) where a=RED, b=GREEN, c=BLUE color values (-2.1 to 2.1 billion)--
* SetLight int LightIndex, int property, int a, int b, int c 
* MoveLight int LightIndex, int x, int y, int z --Shift light to position or direction (x,y,z)
-- FOG FUNCTIONS --
* SetFog int n --Turns fog on (n=1) or off (n=0)
* SetFogColor int r, int g, int b --Sets the fog color, which is an RGB color made up of red, green and blue values betweens 0 and 256
* SetFogDepth int percent --sets percent of fog coverage inside the viewport (default=100%)
-- COLLISION DETECTION --
-- Returns collision info in globals: CollideX, CollideY, CollideZ, CollideObject, CollidePoly, CollideTexture --
* CollideVector int x, int y, int z, int VectorX,  int VectorY, int VectorZ -- Test collision in world from point (x,y,z) using vectors (X,Y,Z)
* CollidePoint int x, int y, int z, int x2,  int y2, int z2 -- Test collision in world from point (x,y,z) to point (x2,y2,z2)
-- 3D CURSOR FUNCTIONS --
* MouseDragObject int ObjectID --Drag object 'ObjectID' with cursor (function must be called continously)
* MouseTurnObject int ObjectID --Rotate object 'ObjectID' with cursor (function must be called continously)
* MouseOverObject --Returns ObjectID of object under cursor
* MouseOverPolygon --Returns index of polygon under cursor
* MouseOverTexture --Returns index of texture under cursor
-- POLYGON FUNCTIONS --
* deletepolygon int ObjectID, int PolygonIndex --Deletes Polygon 'PolygonIndex' in object 'ObjectID'
* flippolygon int ObjectID, int PolygonIndex --Inverts Normal (flips) Polygon 'PolygonIndex' in object 'ObjectID'
* mergepolygons int ObjectID, int PolygonIndex1, int PolygonIndex2 --Deletes Polygon 'PolygonIndex' in object 'ObjectID'
* rotatepolygontexture int ObjectID, int PolygonIndex, float NewAngle --Rotates texture of Polygon 'PolygonIndex' in object 'ObjectID' to angle 'NewAngle'
* setpolygontexture int ObjectID, int PolygonIndex, int TextureID --Sets texture of Polygon 'PolygonIndex' in object 'ObjectID' to texture 'TextureID'
* setpolygonmaterial int ObjectID, int PolygonIndex, int MaterialID --Sets material of Polygon 'PolygonIndex' in object 'ObjectID' to material 'MaterialID'
* getpolygon int ObjectID, int PolygonIndex, int PropID --Gets proprties fro Polygon 'PolygonIndex' in object 'ObjectID'
							 --PropID: 0=type, 1=texture, 2=material, 3=number of vertices in polygon
-- UV MAPPING FUNCTIONS --
* getuvmap int ObjectID, int PolygonIndex, int VertexIndex, int UVselect --Returns U (if UVselect=1) or V (if UVselect=2) 
* setuvmap  int ObjectID, int PolygonIndex, int VertexIndex, int Uvalue, int Vvalue --Sets U and V coordinates of Vertex 'VertexIndex' in Polygon 'PolygonIndex' in object 'ObjectID'
-- VERTEX FUNCTIONS --
* getvertex int ObjectID, int VertexIndex, int PropID --Gets property for vertex 'VertexIndex' in object 'ObjectID' (Props: 1=x,2=y,3=z)
* setvertex int ObjectID, int VertexIndex, int  x, int y, int z --Moves vertex 'VertexIndex' in object 'ObjectID' to position (x,y,z) relative to center of shape
-- 3D WORLD Utilities --
* VectorToAngle int ObjectID --Sets orientation of object 'ObjectID' based on its vector values
* AngleToVector int ObjectID --Sets vector values of object 'ObjectID' based on its orientation
* ObjectDistance int ObjectID1, int ObjectID2 --Returns distance between ObjectID1 and ObjectID2
* PointDistance int x, int y, int z, int x2,  int y2, int z2 -- Returns distance from point (x,y,z) to point (x2,y2,z2)
* GetClippingPlane --Returns the Clipping Plane distance 
* SetClippingPlane int n --Sets Clipping Plane distance to value 'n'
* SetWorldBackground  int ObjectID, int TextureID --Sets object 'ObjectID' as the world's background (if ObjectID>0) and optionally applies texture 'TextureID' (if TextureID>0)
* GetWorldColor --Returns the world's background color as an RGB value (red, green and blue)
* SetWorldColor  int red, int green, int blue --Sets world's background color to RGB values (red, green and blue)
* SetWorldPassword string password--sets the password to use when opening or saving an encrypted GRV file
* ObjectCount -- Returns the number of objects in the world
* PolyCount -- Returns the number of polygons in the world
* GetFPS int ShowFPS -- Returns the current frames per second
-- ASSET FUNCTIONS --
-- Asset Library Strings: ('texture', 'sprite', 'shape', 'material') --
* AssetName string assetlib, int assetID -- Returns the name of an asset from its ID number and lib
* AssetID string assetlib, string assetname -- Returns the ID number of an asset from its name and lib
* TextureID string name -- Returns the asset ID number of a texture from its name
* SpriteID string name -- Returns the asset ID number of a sprite from its name
* ShapeID string name -- Returns the asset ID number of a shape from its name
* MaterialID string name -- Returns the asset ID number of a material from its name
* SpriteIDtoTextureID int SpriteID -- Returns the Texture ID of a sprite bitmap
* Force8BitTextures int n --Force JPG textures to be converted to 8-bit color when loaded if n=1 (dithers texture if n=2)
-- WORLD OBJECT COMMANDS --
* FreezeWorld -- Optimize static geometry. Called after adding static shapes to world 
* DeleteAllObjects -- Remove all objects from a scene 
* ClearWorld -- Remove all objects and clear geometry, textures and sprite data from memory
-- FILE LOADING COMMANDS --
* OpenWorld string filename --Open a GRV world file and ready its contents for loading
* LoadScene string filename --Open a scene file and load its contents
* LoadMaterials string filename --load material definitions file into engine
* LoadShapeFolder string foldername --load Model folder into engine
* LoadTextureFolder string foldername --load Texture folder into engine
* LoadSpriteFolder string foldername --load Sprite folder into engine
* LoadPathFolder string foldername --load Path folder into engine
* LoadTerrain string heightfile, string texturefile --create terrain from a grayscale heightmap and a texture map
* LoadShape string filename --load single Model file into engine
* LoadTexture string filename --load single Texture file into engine
* LoadSprite string filename --load single Sprite file into engine
* LoadPath string filename --load single path file into engine
* ImportModel string filename --Import DXF,3DS, LWO, Quckdraw3D or CAD file into engine
* CloseWorld --Close the current world file and release all associated memory
* AccessWorld --Links a new GRV file to the current world
* ReleaseWorld --Unlinks the current GRV file from all asset loading commands
* SetWorldFolder string FolderName--Sets the current working directory of the GRV file
* GetWorldFileName int FileIndex --Returns the name of the file at index 'FileIndex' in the GRV's current directory
* GetWorldFileIndex string FileName --Returns the index of  file 'FileName' in the GRV's current directory
-- FILE SAVING COMMANDS --
* SaveScene string filename --save a scene file to disk
* SaveObject int ObjectID, string Filename --save an object in file 'Filename'
-- GRV FILE CREATION --
* InitGRVfile string password --Creates empty GRV file with optional password
* AddFolderToGRVfile string folderpath, string savedfoldername --Add folder to GRV file created with InitGRVfile(filename)
* SaveGRVfile string filename  --Saves GRV file 'filename'; called after 'InitWorld' and 'AddFolderToWorld'; password optional
       -- GROOVE BITMAP UTILITIES --
* Add3DPixel int TextureID, int X, int Y, int Z, int Color --Add 3D particle at coordinates (x,y,z) to texture 'TextureID'
* GetPixelValue int TextureID, int X, int Y --Returns the color value of the specified pixel at location (x,y)
* SetPixelValue int TextureID, int X, int Y, int Color --Sets the color value of the specified pixel at location (x,y)
* GetPalette int TextureID, int PaletteIndex --Returns color value of the specified Palette index in Bitmap 'TextureID'
* SetPalette int TextureID, int PaletteIndex, int Red, int Green, int Blue --Sets the color value of the specified Palette index in Bitmap 'TextureID' to RGB color (red, green, blue)
* GetRGBPixel int TextureID, int X, int Y --Returns the RGB color value of the specified pixel at location (x,y)
* SetRGBPixel int TextureID, int X, int Y, int Red, int Green, int Blue --Sets the RGB color value (red, green, blue) of the specified pixel at location (x,y)
* SetRGBLevels int TextureID, int RedPercent, int GreenPercent, int BluePercent --Sets the intensity level of each color component (red, green and blue) of a bitmap
* RGBtoHSB int Red, int Green, int Blue --Returns the Hue, Saturation and Brightness values of a specified RGB color with components (red,green and blue)
-- GROOVE MEMORY UTILITIES --
* GetUsedMem --Returns total amount of memory (in bytes) used by Groove
* GetMemAddress string MediaType, int AssetID --Returns the memory address of a Groove Media Asset (types: 'texture','sprite','shape','material','object','screen'
* ReadRAMbyte int MemAddress --Returns the Byte value stored in RAM address 'MemAddress'
* WriteRAMbyte int MemAddress, int ByteValue --Sets the byte value stored in RAM address 'MemAddress' to 'ByteValue'
-- GROOVE BIT MANIPULATION UTILITIES --
* BitShift int Value, int ShiftBytes --Shifts integer 'Value' by 'ShiftBits' places
* BitAND int Value1, int Value2 --Returns the result of Boolean AND operation between integers 'Value1' and 'Value2'
* BitOR int Value1, int Value2 --Returns the result of Boolean OR operation between integers 'Value1' and 'Value2'
* BitXOR int Value1, int Value2 --Returns the result of Boolean XOR operation between integers 'Value1' and 'Value2'
-- GROOVE ENCRYPTION UTILITIES --
* Encrypt string data, String Key --Returns encrypted text 'data' using password string 'key'
* Decrypt string data, String Key --Returns decrypted text 'data' using password string 'key'
-- GROOVE TEXT UTILITIES --
* FindText string text, String findstring --returns the location of the first character of string 'findstring' in string 'text'
-- GROOVE OS UTILITIES --
* SetWorkingDir string pathname --Set the current working directory to 'pathname'
* GetWorkingDir --Returns the current working directory
* GetFileSize string FileName --Returns the number of bytes in file 'FileName'
* ReadFile string FileName --Returns string of text data in 'FileName'
* SaveFile string Data, string FileName --Saves string 'Data' inside file 'FileName'
* SaveData string Data, int DataLength, string FileName --Saves byte stream 'Data' inside file 'FileName'
* CopyFile string source, string destination --Copy file 'source' to file(+path) 'destination'
* MergeFile string sourcefile1, string sourcefile2, string destination --Merges files 'sourcefile1' and 'sourcefile2' into file(+path) 'destination'
* ExtractFile string source, int ChunkStart, int ChunkSize, string destination --Extract file 'destination' from file 'source' using data starting at 'ChunkStart'
* CreateFolder string FolderName --Creates new folder 'FolderName' inside current directory
* YesNoAlert string Message --Opens alert box with 'yes' (returns 1), 'no' (returns 0) and 'cancel' (returns 2) buttons
* GetKeyDown string n --Returns true if 'n'=last key pressed
* AppLock int n --Disables system reboot, reset and quit keys while application is running (on: n=1; off: n=0)
-- MOUSE COMMANDS --
* MouseWrap int n -- forces mouse to wrap around edges of the screen if n=1
* MoveCursor int X, int Y -- Moves the cursor to global screen coordinates (X,Y)
* MouseX -- Returns horizontal mouse position in global screen coordinates
* MouseY -- Returns vertical mouse position in global screen coordinates
--MEDIA COMMANDS --
* transfer3DMedia any srcCMem, any dstCMem, string label, string format -- xfer media (cast#1)
* save3DMedia any srcCMem, string pathname -- Save media to pathname
* read3DMedia any dstCMem, string pathname -- Read media from pathname
--ENGINE PROPERTIES --
-- PrefIDnumbers: 1=maxtextures,2=maxsprites,3=maxshapes,4=maxobjects,5=maxmaterials,6=maxpolys,7=maxshapepolys,8=maxshapedots,9=maxlights
* SetGroovePref int prefIDnumber, int prefvalue -- Set 3D Groove Porperty 'prefIDnumber' with value 'prefvalue'
* SetGrooveLog string LogFileName, int MaxLogFileSize -- Logs debug information in file 'LogFileName' (if maxfilesize=0 then log is replaced every session)
* SetGrooveAlert int n -- Turns Groove alert messages on (if n=1) or off (if n=0) '
* EditShape string texturefolder, string filename -- Load model in 3D Editor
* GrooveVersion -- Returns 3D Groove Engine version number